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Chapter 1 


DNET Connection Manager API 


1.1 References 


[1] Software Architecture Document, Version 1.1 Revision 1.4, LiMo Foundation, 11 September 2007 


1.2 Overview 


This document describes the Foundation API for the Connection Manager (CM) component of the LiMo 
Data Networking framework. This document also includes sample call flows (MSCs) for Connection Man- 
ager interface Call Flow Diagrams. The call flows have been provided to get a better understanding of 
Connection Manager API’s and use cases. 


1.3 Industry Standard 


None 


1.4 External API Documents 


None 


1.5 Plug-in Extension Point Interface 


None 


1.6 Other Interfaces 


None 


2 DNET Connection Manager API 


1.7 Other Notes 


See Call Flow Diagrams for more information. 
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Chapter 2 


Module Index 


2.1 Modules 


Here is a list of all modules: 


Connection Manager < s s sosa op e R R NR NR RR RRR RR KRN K N NE d 11 
Profile: Manager. cog 244% 2b 46 di E a cde H E E R eed 28 


Module Index 
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Chapter 3 


Data Structure Index 


3.1 Data Structures 


Here are the data structures with brief descriptions: 


IpAddr E(IP Address)! on coi aa A a ee Oe IR Bw 
NetAddr_t (Network Address information)... 
NetAuthInfo_t (PDP Authentication Information ) . . . . a 00.00.0004 eee 
NetBssInfo_t (BSS Information ) . . .. aoaaa a 
NetCMTunnelInfo_t (Tunnel data: Used in sending tunnel request to Connection Manager ). . . 
NetDevInfo_t (Device Info in Connect response event) ...... o... o... .. +... . .. 
NetEventInfo_t (Event Info with Event on callback from Connection Manager) ......... 
NetEventTunnelIndInfo_t (Event Info with Event on Indication from Connection Manager)... 
NetPdpProfileInfo_t (PDP Profile Profile Information) ....................2.4. 
NetPdpQosGprs_t (PDP GPRS Qos Information) . . . o. a e... e... 
NetPdpQosInfo_t (PDP Qos Information ) . . 0... e... ee eee eee 
NetPdpQosUmts_t (PDP UMTS(3G) Qos Information). .................004. 
NetProfile_t (Profile data structures: Used between CM and PM Plug-in Interface) ....... 
NetWlanProfileInfo_t (WLAN Profile Profile Information ) . . . a a aa 
ProfileInfo_t (Profile information : Union of PDP and WLAN profile information) ....... 
Qos_t (Union of different type of Qos Into)... 


Data Structure Index 
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Chapter d 


File Index 


4.1 File List 


Here is a list of all documented files with brief descriptions: 


ComponentOverview.h (Component Programming Interface Overview Header Template for 

Doxygen) coca de toa NN 
NetCMConfig.h (This file describes vendor specific configurable constants of CM Module). . . 
NetCMError.h (This file defines the common error code)... 
NetCMIntf.h (This file defines the interface of Connection Manager with the application)... . 
PMIntf.h (This file defines the interface of Profile Manager with the application/Connection Man- 

T E & & oh & Sed a Bde Boye rE a 


File Index 
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Chapter 5 


Page Index 


5.1 Related Pages 


Here is a list of all related documentation pages: 


10 


Page Index 
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Chapter 6 


Module Documentation 


6.1 Connection Manager 


Files 


e file NetCMConfig.h 
This file describes vendor specific configurable constants of CM Module. 


s file NetCMError.h 


This file defines the common error code. 


e file NetCMIntf.h 


This file defines the interface of Connection Manager with the application. 


Data Structures 


s struct NetEventInfo_t 


Event Info with Event on callback from Connection Manager. 


s struct NetEventTunnelIndInfo_t 


Event Info with Event on Indication from Connection Manager. 


s struct NetDevInfo_t 


Device Info in Connect response event. 


s struct NetCMTunnellnfo_t 


Tunnel data: Used in sending tunnel request to Connection Manager. 


Defines 


s #define NET_CONNECTIONS_MAX NET_CONNECTIONS_MAX_VENDOR_DEFINED 


Maximum Number of Connections that can be established simultaneously-It is Vendor specific value. 
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e #define NET DEVICE NAME LEN MAX  NET_DEVICE_NAME_LEN_MAX_VENDOR_- 
DEFINED 


Maximum length of device name that will be created after a successful connection establishment-It is Vendor 
specific value. 


s #define NET_DNS_ADDR_MAX NET_DNS_ADDR_MAX_VENDOR_DEFINED 
MAX number of DNS Address-It is Vendor specific value. 


Typedefs 


e typedef void(* NetAppEvtCb_t )(const NetEventInfo_t *NetEvent) 


callback function: used to notify client application about Asynchronous events. 


Enumerations 


e enum NetErr_t 1 


NET ERR NONE = 0x00, NET_ERR_UNKNOWN , NET_ERR_APP_ALREADY_- 
REGISTERED, NET_ERR_APP_REGISTRATION_FAILED, 


NET_ERR_APP_MAX_CLIENT_REGISTERED, NET_ERR_INVALID_CLIENT, NET_ERR_- 
INVALID_PROFILEID, NET_ERR_NO_ACTIVE_CONNECTIONS, 


NET_ERR_ACTIVE_CONNECTION_EXISTS, NET_ERR_CONNECTION_KILLING, NET_- 
ERR_CONNECTION_OPENING, NET_ERR_CONNECTION_CLOSING, 


NET_ERR_MAX_CONNECTIONS, NET_ERR_MAX_CLIENTS_PER_CONNECTION, NET_- 
ERR_MAX_CONNECTION_KILL_REQ, NET_ERR_MAX_TUNNEL_REQ, 


NET_ERR_ACCESS_DENIED, NET_ERR_INVALID_PARAM, NET_ERR_INVALID_- 
OPERATION, NET_ERR_TRANSPORT, 


NET_ERR_CONNECTION_KILLED } 


Error Defination. 


enum NetEvent_t 1 


NET_EVENT_OPEN_RSP, NET_EVENT_CLOSE_RSP, NET EVENT KILL RSP, NET_- 
EVENT_CLOSE_IND, 


NET_EVENT_SUSPEND_IND, NET_EVENT_RESUME_IND, NET_EVENT_TUNNEL_RSP, 
NET_EVENT_TUNNEL_IND } 


Callback Event. 


enum NetTransportType_t { NET_TRANSPORT_TYPE_PDP, NET_TRANSPORT_TYPE_- 
WLAN } 


Transport Type. 
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Functions 


int NetCMClientRegister (NetAppEvtCb_t EventCb) 


This API shall register the client application with the CM server. 


int NetCMClientDeRegister () 


This API will deregister the client application with the CM server. 


int NetCMConnectionOpen (int Profileld[ ], int ProfileCount) 


This API will establish a data connection for the first entry in the array Profileld. 


int NetCMConnectionClose (int Profileld) 


This API will terminate the connection referred by the Profileld. 


int NetCMDeviceGetInfo (int Profileld, NetDevInfo_t *DevInfo) 


This API shall get the device information associated with the connection referred by the Profileld. 


int NetCMGetActiveProfileIDs (int Profileld[ ], int *ProfileCount) 
This API will retrieve all active profile IDs. 


int NetCMGetTransportError (int «Error) 


This API returns transport specific error cause for the synchronous return of the last initiated API request. 


int NetCMConnectionKill (int ProfileId) 
This API shall kill active connection referred by the Profileld. 


int NetCMTunnelRequest (NetCMTunnelInfo_t «TunnelData) 


This API will be used to send any transport specific proprietary information to transport plug-in. 


6.1.1 Define Documentation 


6.1.1.1 #define NET_CONNECTIONS_MAX NET_CONNECTIONS_MAX_ VENDOR _ - 


DEFINED 


Maximum Number of Connections that can be established simultaneously-It is Vendor specific value. 


6.1.1.2 #define NET_DEVICE_NAME_LEN_MAX NET_DEVICE_NAME_LEN_MAX - 


VENDOR_DEFINED 


Maximum length of device name that will be created after a successful connection establishment-It is 
Vendor specific value. 


6.1.1.3 #define NET_DNS_ADDR_MAX NET_DNS_ADDR_ MAX VENDOR_DEFINED 


MAX number of DNS Address-It is Vendor specific value. 
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6.1.2 Typedef Documentation 
6.1.2.1 typedef void(* NetAppEvtCb_t)(const NetEventInfo_t «NetEvent) 


callback function: used to notify client application about Asynchronous events. 


This callback function will be called in the CM Client library context.It should not call any of the CM 
foundation APIs. 


Note: 


CM will allocate the memory for event data. Once Context will return from callback then CM will 
free the memory allocated to event data. Application is not supposed to free the memory pointed by 
NetEvent 


6.1.3 Enumeration Type Documentation 
6.1.3.1 enum NetErr_t 


Error Defination. 


Enumerator: 


NET_ERR_NONE No error. 

NET_ERR_UNKNOWN Error unknown. 

NET_ERR_APP ALREADY REGISTERED Application is already registered with the CM. 
NET_ERR_APP_REGISTRATION_FAILED Application could not register with CM. 


NET_ERR_APP_MAX_CLIENT_REGISTERED Reached the maximum number of clients regis- 
tered. 


NET_ERR_INVALID_CLIENT Client is invalid - It may be unregistered. 
NET_ERR_INVALID_PROFILEID Profile does not exist for the given Profileld. 


NET_ERR_NO_ACTIVE_CONNECTIONS No active connection exists for the given client or pro- 
file ID. 


NET_ERR_ACTIVE_CONNECTION_EXISTS Active connection already exists for the given pro- 
file ID. 


NET_ERR_CONNECTION_KILLING Connection is getting killed. 
NET_ERR_CONNECTION_OPENING Connention is in connecting state;. 
NET_ERR_CONNECTION_CLOSING Connention is in disconnecting state;. 
NET_ERR_MAX CONNECTIONS Reached the maximum number of connections. 


NET_ERR_MAX_CLIENTS_PER_CONNECTION Maximum Client for a given active connec- 
tion. 


NET EKK MAX CONNECTION KILL REO Connection Kill request is failed as maximum kill 
request is pending. 

NET_ERR_MAX_TUNNEL_REQ Maximum Tunnel Request is being processed by CM. 

NET_ERR_ACCESS_DENIED Access is denied. 

NET_ERR_INVALID_PARAM Invalid value of API parameter. 

NET_ERR_INVALID_OPERATION invalid operation depending on current state 

NET_ERR_TRANSPORT Transport specific error. 

NET_ERR_CONNECTION_KILLED Connection killed by other privileged application. 
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6.1.3.2 enum NetEvent_t 
Callback Event. 


Enumerator: 


NET_EVENT_OPEN_RSP Open Connection Response Event 
Response event for NetCMConnectionOpen to notify the status of open connection request 
Detail of Event Info in Open Response Event (NetEventInfo_t):- 
Event: Its value will be NET_EVENT_OPEN_RSP 
Profileld: ID for which connection has been activated 


Error: Its value will be NET ERR NONE in case of success and error cause in case of failure 


If its value is NET_ERR_TRANSPORT, application can retrieve the transport specific error using 
Data field (Data will be of type Int in this case) 


Data: In case of success, it will point to data of type NetDevInfo_t 
If the error value is NET_ERR_TRANSPORT, it will point to transport specific error (Data will 
be of type Int in this case). 
NET_EVENT_CLOSE_RSP Close Connection Response Event 
Response event for NetConnectionClose to notify the status of close connection request 


Detail of Event Info in Close Response Event (NetEventInfo_t):- 
Event: Its value will be NET_EVENT_CLOSE_RSP 
Profileld: Profile ID for which Close Connection was requested 


Error: Its value will be NET_ERR_NONE in case of success and error cause in case of failure 


If its value is NET_ERR_TRANSPORT, application can retrieve the transport specific error using 
Data field (Data will be of type Int in this case) 


Data: In case of success, it will be NULL, If the error value is NET_ERR_ TRANSPORT, it will 

point to transport specific error (Data will be of type Int in this case). 
NET_EVENT_KILL_RSP Kill Connection Response Event 

Response event for NetCMConnectionKill to notify the status of kill connection request 

Detail of Event Info in Kill Response Event (NetEventInfo_t):- 

Event: Its value will be NET EVENT KILL RSP 

Profileld: Profile ID of the connection for which Kill Connection was requested 

Error: Its value will be NET_ERR_NONE in case of success and error cause in case of failure 


If its value is NET_ERR_TRANSPORT, application can retrieve the transport specific error using 
Data field (Data will be of type Int in this case) 


Data: In case of success, it will be NULL, If the error value is NET_ERR_ TRANSPORT, it will 
point to transport specific error (Data will be of type Int in this case). 
NET_EVENT_CLOSE_IND Connection Close Indication Event 


Indication to notify the closure of an active connection due to network initiated termination or 
any other transport connectivity loss. 


Detail of Event Info in close Indication Event (NetEventInfo_t):- 
Event: Its value will be NET_EVENT_CLOSE_IND 
Profileld: Profile ID for which the connection got disconnected 


Error: Its value will be NET_ERR NONE in case of success and error cause in case of failure 
If its value is NET_ERR_TRANSPORT, application can retrieve the transport specific error using 
Data field (Data will be of type Int in this case) 

Data: In case of success, it will be NULL, If the error value is NET_ERR_ TRANSPORT, it will 
point to transport specific error (Data will be of type Int in this case). 
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NET_EVENT_SUSPEND_IND Connection Suspend Indication Event 
Indication to notify that data transfer in a connection is suspended 
Detail of Event Info in Suspend Indication Event (NetEventInfo_t) :- 
Event: Its value will be NET_EVENT_SUSPEND_IND 
Profileld: Profile ID of the connection for which the data transfer is suspended 


Error: It will be the reason for data suspension.If its value is NET_ERR_TRANSPORT, applica- 
tion can retrieve transport specific cause using Data field(Data will be of type Int in this case) 
Data: If the Error value is NET_ERR_TRANSPORT, it will point to transport specific error (Data 
will be of type Int in this case). 

NET_EVENT_RESUME_IND Connection Resume Indication Event 
Indication to notify that data transfer in a connection has resumed 
Detail of Event Info in Resume Indication Event (NetEventInfo_t):- 
Event: Its value will be NET EVENT RESUME IND 
Profileld: Profile ID of the connection for which the data transfer has resumed 
Error: It will be the reason for resumption of data transfer 


If its value is NET_ERR_TRANSPORT, application can retrieve transport specific cause using 
Data field(Data will be of type Int in this case) 
Data: If the Error value is NET_ERR_TRANSPORT, it will point to transport specific error (Data 
will be of type Int in this case). 
NET_EVENT_TUNNEL_RSP Tunnel Response Event 
Response event for NetCMTunnelRequest to notify the status of Tunnel request. 
Detail of Event Info in Tunnel Response Event (NetEventInfo_t):- 
Event: Its value will be NET_EVENT_TUNNEL_RSP 
Profileld: Its value is irrelevant 
Error: its value will be irrelevant 
Data: This will point to data of type: NetCMTunnelInfo_t, Application and transport plug-in can 
use this to communicate any data CM is unaware of any information regarding this data. 
NET_EVENT_TUNNEL_IND Tunnel Indication Event 
Indication to notify any transport specific Tunnel event (other than response events) from trans- 
port plug-in 
Tunnel Indication is sent from Connection manager server to registered application via Event 
Delivery.Actual Event Delivery Name for this event is Networking.Connection.TunnelInd. 
Structure associated with Tunnel Indication: NetEventTunnelIndInfo_t 
Event: Its value will be NET_EVENT_TUNNEL_IND 
TransportType: Transport type of Tunnel Indication 
Len: length of the data buffer 


Data: Event Data Buffer. 
Note: 


Client application receives this event from ED in Base64 encoded format. Application needs 
to decode the event data and typecast the event data into data type: NetEventTunnelIndInfo_t 


6.1.3.3 enum NetTransportType_t 


Transport Type. 


Enumerator: 


NET_TRANSPORT_TYPE_PDP PDP Transport type. 
NET_TRANSPORT_TYPE_WLAN WLAN Transport type. 
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6.1.4 Function Documentation 
6.1.4.1 int NetCMClientDeRegister () 


This API will deregister the client application with the CM server. 
Sync (or) Asyne: 
This is a Synchronous API. 


Important Notes: 


After deregistration, Application will be restricted from using other CM APIs/Services. 
De-register is not allowed when any connection is in active or transition state (connection kill, activa- 
tion or deactivation in progress). 


Warning: 
None 

Async Response Message: 
None 

Precondition: 


Application must already be registered with the CM server. 


Returns: 


Return Type (int) 


NET_ERR_NONE - indicating that the operation has completed successfully. 
NET_ERR_INVALID_CLIENT -indicating that client is not registered with CM and it cannot 
use CM services. 

NET_ERR_ACTIVE_CONNECTION_EXISTS -indicating that an active connection is associ- 
ated with the client and deregistration is not possible. 

NET_ERR_CONNECTION_OPENING -indicating that a connection associated with the client 
is opening and deregistration is not possible. 

NET_ERR_CONNECTION_CLOSING -indicating that a connection associated with the client 
is closing and deregistration is not possible. 

NET_ERR_CONNECTION_KILLING - indicating that a connection associated with the client 
is being killed or client is killing some connection.Deregistration is unsuccessful. 
NET_ERR_UNKNOWN -indicating that an unknown error has occured. 


Prospective Clients: 


External Apps. 


Example Program: 


int result; 
result = NetCMClientDeRegister ( ); 
if(result == NET_ERR_NONE.)......... 
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6.1.4.2 int NetCMClientRegister (NetAppEvtCb_t EventCb) 
This API shall register the client application with the CM server. 


Sync (or) Asyne: 
This is a Synchronous API. 


Important Notes: 


It is mandatory for the client application to register with CM server with this API before using any of 
its services. 

The value of EventCb cannot be NULL. Otherwise, error NET ERR INVALID PARAM will be re- 
turned by the API. 

All the Asynchronous Events from CM server will be sent to the client App through the callback 
function (EventCb) registered with this API. 


Warning: 
None 
Parameters: 
EventCb [IN] Application callback to receive CM events. 
Async Response Message: 
None. 
Precondition: 
None. 


Returns: 


Return Type (int) 


e NET_ERR_NONE - indicating that the operation has completed successfully. 
e NET_ERR_INVALID_PARAM - indicating that API parameter value is invalid. 


e NET_ERR_APP_ALREADY_REGISTERED - indicating that client application is already regis- 
tered, it can not be registered again. 


e NET_ERR_APP_MAX_CLIENT_REGISTERED - indicating that maximum number of clients 
have already been registered . 


e NET_ERR_APP_REGISTRATION_FAILED - indicating that registration has failed. 


Prospective Clients: 


External Apps. 


Example Program: 


int result; 
result = NetCMClientRegister( CallBack ); 
if(result == NET_ERR_NONE.)......... 
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6.1.4.3 int NetCMConnectionClose (int ProfileId) 


This API will terminate the connection referred by the Profileld. 


This API can also be used to abort a connection in progress. 


Sync (or) Asyne: 


This is a Asynchronous API. 


Important Notes: 


This API is an asynchronous API .Return value only implies whether the request is sent successfully 
or not. Return value Success doesn’t imply that the connection is disconnected successfully. 

This API will close the physical link for the connection (referred by the profile ID) only if it is the only 
client using the connection. 

For every connection established with the NetCMConnectionOpen API, client Application should dis- 
connect the connection with this API whenever it doesn’t require the connection. 

This API can also be used to abort a connection in progress, before receiving the NET_EVENT_- 
OPEN_RSP response event 

A positive integer is a valid value for the Profile ID. 


Warning: 
None 


Notes : 


CM requests transport to close the connection only if there are no other applications using the active 
connections associated with the profile ID 


Parameters: 


ProfileId [IN] Profile Identifier 


Async Response Message: 


NET_EVENT_CLOSE_RSP: Connection Close response will be sent asynchronously to the App in 
the callback function registered as NET_EVENT_CLOSE_RSP event. 


Precondition: 


Application must have a active data connection associated with the Profileld 


Returns: 
Return Type (int) 


e NET_ERR_NONE - indicating that the operation has completed successfully. 

e NET_ERR_INVALID_CLIENT -indicating that client is not registered with CM and it cannot 
use CM services. 

NET_ERR_INVALID_PROFILEID -indicating that profile ID parameter passed in the API is 
invalid. 


NET_ERR_NO_ACTIVE_CONNECTIONS -indicating that there is no active connection asso- 
ciated with the client for the requested profile ID. 
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e NET_ERR_CONNECTION_KILLING -indicating that client has already requested for killing 
the connection(referred by the parameter profileld). 


e NET_ERR_CONNECTION_CLOSING -indicating that client has already requested for closing 
the connection(referred by the parameter profileld). 


e NET_ERR_UNKNOWN -indicating that an unknown error has occured. 
Prospective Clients: 


External Apps. 


Example Program: 


int result; 
result = NetCMConnectionClose( Profileld ); 
if(result == NET_ERR_NONE.)......... 


6.1.4.4 int NetCMConnectionKill (int ProfileId) 


This API shall kill active connection referred by the Profileld. 


Kill request will bring the physical link down for the connection referred by the profile ID. 


Sync (or) Asyne: 
This is a ASynchronous API. 


Important Notes: 


API is a asynchronous API. Return value only implies whether the request is sent successfully or not. 
Return value Success does not imply that the connection is killed successfully. 

Once Connection has been successfully killed, then event NET_EVENT_CLOSE_IND will send to 
application which has opened the connection and event NET_EVENT_KILL_RSP to the application 
calling this API. 

NET EVENT KILL RSP will be sent to application calling this API even if the same application has 
opened the connection. 

A positive integer is a valid value for the Profile ID. 


Warning: 

API must be called from privileged application only. 
Parameters: 

ProfileId [IN] Profile Identifier 
Async Response Message: 


Connection Kill response will be sent asynchronously to the App in the callback function registered as 
NET_EVENT_KILL_RSP event. 


Precondition: 


Application must already be registered with the CM server. API must be called from privileged appli- 
cation only. 
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Returns: 


Return Type (int) 


NET_ERR_NONE - indicating that the operation has completed successfully. 
NET_ERR_INVALID_CLIENT -indicating that client is not registered with CM and it cannot 
use CM services. 

NET_ERR_CONNECTION_KILLING - indicating that the connection is already being killed 
by the same client. 

NET_ERR_MAX_CONNECTION_KILL_REQ -indicating that maximum number of kill re- 
quests are already being processed by CM 

NET_ERR_INVALID_PROFILEID -indicating that profile ID parameter passed in the API is 
invalid. 


NET_ERR_UNKNOWN -indicating that an unknown error has occured. 


Prospective Clients: 


External Apps. 


Example Program: 


int result; 

int Profileld; 

result = NetCMConnectionKill( Profileld ); 
if(result == NET_ERR_NONE).......... 


6.1.4.5 int NetCMConnectionOpen (int Profileld[ ], int ProfileCount) 
This API will establish a data connection for the first entry in the array Profileld. 


Sync (or) Asyne: 


This is a Asynchronous API. 


Important Notes: 


This API is a Non-Blocking API.Return value only implies whether the request is sent successfully or 
not. Return value Success does not imply that the connection is established successfully. 

If client Application requires multiple connections, it can call this API multiple times. 

If Application calls this API for multiple times, NET_EVENT_OPEN_RSP will be sent multiple times, 
once for each connection request. 

If the Profileld is O, default profile will be used in connection. CM will retrieve the default profile 
ID using Profile Manager framework API: NetPMGetDefaultProfileld. In this case NET_EVENT_- 
OPEN_RSP will contain actual profile Id corresponding to default profile setting for which connection 
has been activated. 

For other positive values of Profileld, corresponding profiles will be used in connection. If the Profileld 
is less than O, error will be returned. 

If Connection is already active for the given profile, This API will share the active connection with the 
calling application. 

If Connection is already active for the given profile, and same application is trying to open connection, 
this API will return error. 
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Notes : 


CM requests transport plug-in interface to open a new connection only if connection is not already estab- 
lished. If there is already a connection with same profile, then same connection will be shared. 
Warning: 


None 


Parameters: 


Profileld[ ] [IN] Array of Profile IDs 
ProfileCount [IN] Number of IDs in the list 


Async Response Message: 


NET_EVENT_OPEN_RSP: Connection Establishment response will be sent asynchronously to the 
App in the callback function registered as NET_EVENT_OPEN_RSP event. 


Precondition: 


Application must already be registered with the CM server. 


Returns: 
Return Type (int) 


e NET_ERR_NONE - indicating that the operation has completed successfully. 

e NET_ERR_INVALID_CLIENT -indicating that client is not registered with CM and it cannot 
use CM services. 

NET_ERR_INVALID_PARAM - indicating that API parameter value is invalid. 


NET_ERR_INVALID_PROFILEID -indicating that profile ID parameter passed in the API is 
invalid. 


NET_ERR_ACTIVE_CONNECTION_EXISTS -indicating that there is already a active connec- 
tion associated with the client for the requested profile ID. 


NET_ERR_CONNECTION_OPENING -indicating that the client has already requested open 
connection for the same profile ID. 


NET_ERR_MAX_CLIENTS_PER_CONNECTION -indicating that connection is already being 
shared by maximum number of clients. 


NET_ERR_MAX_CONNECTIONS -indicating that maximum number of connection requests 
have already been processed by CM 


NET_ERR_INVALID_OPERATION - indicating that open connection operation is not allowed 
in the current state. 


NET_ERR_TRANSPORT - Indicating that Transport error had happened; Client need to call 
NetCMGetTransportError to find error cause 


NET_ERR_UNKNOWN -indicating that an unknown error has occured. 


Prospective Clients: 


External Apps. 
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Example Program: 


int result; 
result = NetCMConnectionOpen( Profileld ,ProfileCount); 
if(result == NET_ERR_NONB)...... 


6.1.4.6 int NetCMDeviceGetInfo (int ProfileId, NetDevInfo_t x DevInfo) 
This API shall get the device information associated with the connection referred by the Profileld. 


Sync (or) Asyne: 
This is a Synchronous API. 


Important Notes: 


On success, device information will be copied into DevInfo parameter. Calling Application should 
allocate memory for the output parameter DevInfo. 

This API returns NET_ERR_NO_ACTIVE_ CONNECTIONS if there is no active connection activated 
by the application with the requested profile ID. 

A positive integer is a valid value for the Profile ID 


Warning: 
None 


Notes: 


Calling application must have a active data connection associated with the Profileld. 


Parameters: 


Profileld [IN] Profile ID of the connection 


DevInfo [OUT] Structure to store device information. 


Async Response Message: 


None 


Precondition: 


Calling application must have a active data connection associated with the Profileld. 


Returns: 
Return Type (int) 
e NET_ERR_NONE - indicating that the operation has completed successfully. 
NET_ERR_INVALID_PARAM - indicating that API parameter value is invalid. 


NET_ERR_INVALID_CLIENT -indicating that client is not registered with CM and it cannot 
use CM services. 


NET_ERR_NO_ACTIVE_CONNECTIONS -indicating that there is no active connection asso- 
ciated with the client for the requested profile ID. 
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e NET_ERR_INVALID_PROFILEID -indicating that profile ID parameter passed in the API is 
invalid. 


Prospective Clients: 


External Apps. 


Example Program: 


int result; 

NetDevInfo_t devInfo; 

result = NetCMDeviceGetInfo( Profileld, &devInfo ); 
if(result == NET_ERR_NONE)...... 


6.1.4.7 int NetCMGetActiveProfileIDs (int Profileld[ ], int x ProfileCount) 
This API will retrieve all active profile IDs. 


Sync (or) Async: 


This is a Synchronous API. 


Important Notes: 


API will return error if there is no active connections available. 

On Success, active profile ids will be copied to Profileld array and number of active profile will be 
updated in ProfileCount. 

Calling application should allocate memory for the output parameters Profileld array and Profileld- 
Count. Profileld array should contain memory of size NET_CONNECTIONS_MAX. 

A positive integer is a valid value for the Profile ID. 


Warning: 


API can be called by privileged application only. 


Parameters: 
Profileld[ | [OUT] Array of active profile Identifiers.(Array of size NET_CONNECTIONS_MAX ) 
ProfileCount [OUT] Number of active profile Identifiers 


Async Response Message: 
None 


Precondition: 


Application must already be registered with the CM server. API must be called from privileged appli- 
cation only. 


Returns: 


Return Type (int) 
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e NET_ERR_NONE - indicating that the operation has completed successfully. 
e NET_ERR_INVALID_PARAM - indicating that API parameter value is invalid. 
e NET_ERR_NO_ACTIVE_CONNECTIONS -indicating that there are no active connections. 


e NET_ERR_INVALID_CLIENT -indicating that client is not registered with CM and it cannot 
use CM services. 


e NET_ERR_UNKNOWN -indicating that an unknown error has occured. 
Prospective Clients: 


External Apps. 


Example Program: 


int result; 

int Profileld[NET_PROFILE_COUNT_MAX]; 

int ProfileCount; 

result = NetCMGetActiveProfileIDs( Profileld, &ProfileCount ); 
if(result == NET_ERR_NONE).......... 


6.1.4.8 int NetCMGetTransportError (int « Error) 
This API returns transport specific error cause for the synchronous return of the last initiated API request. 


Sync (or) Asyne: 


This is a Synchronous API. 


Important Notes: 


This API is not required for retrieving transport specific errors for the asynchronous response of API. 
Asynchronous response event already contains the transport error cause in the event data structure. 

If any other CM API returns failure with return value NET_ERR_TRANSPORT, then client applica- 
tion can retrieve actual error cause through this API. 

API is a synchronous API and error will be stored in parameter Error passed in this API. 

Application has to allocate memory for the Error parameter. 

CM stores transport error value on per client basis. So, the same API can return different values for 
different clients. But, if the same application calls another CM API, the error reason is over-written 
and this API call may return a new error this time. 


Warning: 
None 


Parameters: 


Error [OUT] Transport error code 


Async Response Message: 


None 
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Precondition: 


Application must already be registered with the CM server. 


Returns: 
Return Type (int) 


e NET_ERR_NONE - indicating that the operation has completed successfully. 


e NET_ERR_INVALID_CLIENT -indicating that client is not registered with CM and it cannot 
use CM services. 


e NET_ERR_INVALID_PARAM - indicating that API parameter value is invalid. 
Prospective Clients: 


External Apps. 


Example Program: 


int result; 

int Error; 

result = NetCMGetTransportError( Error ); 
if(result == NET_ERR_NONE).......... 


6.1.4.9 int NetCMTunnelRequest (NetCMTunnelInfo_t x TunnelData) 
This API will be used to send any transport specific proprietary information to transport plug-in. 


Sync (or) Async: 
This is a ASynchronous API. 


Important Notes: 


API is a Non-Blocking API.Return value only implies whether the request is sent successfully or not. 
Return value Success does not imply that the request is successfully executed. 

Application has to allocate memory for the TunnelData parameter and TunnelData->Data parameter. 

CM does not understand any internal data structure for tunnel request. Application should allocate 
memory for all the data and should not pass any unallocated pointer in TunnelData->Data. 

CM will generate a unique request number and return it to application in Request Id member of struc- 
ture: NetCMTunnelInfo_t. 


Warning: 

None 
Parameters: 

TunnelData [IN/OUT] Transport specific tunnel data. 
Async Response Message: 


NET_EVENT_TUNNEL_RSP: Tunnel response will be sent asynchronously to the Application in the 
registered callback as NET_EVENT_TUNNEL_RSP event 


Generated on Fri Feb 1 01:01:00 2008 by Doxygen 


6.1 Connection Manager 27 


Precondition: 


Application must already be registered with the CM server. 


Returns: 
Return Type (int) 


e NET_ERR_NONE - indicating that the operation has completed successfully. 


e NET_ERR_INVALID_CLIENT -indicating that client is not registered with CM and it cannot 
use CM services. 


e NET_ERR_INVALID_PARAM - indicating that API parameter value is invalid. 


e NET_ERR_MAX_TUNNEL_REQ -indicating that maximum number of tunnel requests are al- 
ready being processed by CM 


e NET_ERR_ UNKNOWN -indicating that an unknown error has occured. 


e NET_ERR_ TRANSPORT -indicating that Transport error had happened; Client need to call 
NetCMGetTransportError to find error cause 


Prospective Clients: 


External Apps. 


Example Program: 


NetCMTunnellnfo_t TunnelData; 

NetTransportType_t Transport; 

int result; 

result = NetCMTunnelRequest( Transport, &TunnelData ); 
if(result == NET_ERR_NONE).......... 
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6.2 Profile Manager 


Files 


e file PMIntf.h 


This file defines the interface of Profile Manager with the application/Connection Manager. 


Data Structures 


e union IpAddr_t 
IP Address. 


e struct NetPdpQosGprs_t 
PDP GPRS Qos Information. 


e struct NetPdpQosUmts_t 
PDP UMTS(3G) Qos Information. 


e union Qos_t 


Union of different type of Qos Info. 


s struct NetAddr_t 


Network Address information. 


e struct NetPdpQosInfo_t 
PDP Qos Information. 


s struct NetAuthInfo_t 


PDP Authentication Information. 


e struct NetPdpProfileInfo_t 
PDP Profile Profile Information. 


s struct NetBssInfo_t 
BSS Information. 


s struct NetWlanProfileInfo_t 
WLAN Profile Profile Information. 


s union ProfileInfo_t 


Profile information : Union of PDP and WLAN profile information. 


s struct NetProfile_t 


Profile data structures: Used between CM and PM Plug-in Interface. 
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Defines 


s #define NET_PDP_AUTH_USERNAME_LEN_MAX 32 


Maximum length of username in PDP profile. 


s #define NET_PDP_AUTH_PASSWORD_LEN_MAX 32 
Maximum length of password in PDP profile (used in authentication parameters) [3GPP Defined variable]. 


s #define NET_PDP_APN_LEN_MAX 255 
Maximum length of APN in PDP profile [3GPP Defined variable]. 


Enumerations 


enum NetProfileType_t { NET_PROFILE_TYPE_PDP, NET_PROFILE_TYPE_WLAN, NET_- 
PROFILE_TYPE_ALL } 


Profile Type. 


enum NetAddrType_t { NET_ADDR_IPV4 = 0x0, NET_ADDR_IPV6 = 0x1 } 
Address Type. 


enum NetAuthType_t { NET_PDP_AUTH_NONE = 0x0, NET PDP AUTH PAP = 0x1, NET_- 
PDP_AUTH_CHAP = 0x2 } 


PDP Authentication Type. 


enum NetPdpQosType_t { NET_PDP_QOS_GPRS, NET_PDP_QOS_UMTS } 
PDP Qos Type. 


enum NetBssType_t { NET_EVENT_WLAN_BSSTYPE_INFRA, NET_EVENT_WLAN_- 
BSSTYPE_ADHOC, NET_EVENT_WLAN_BSSTYPE_BOTH } 


BSS Information. 


Functions 


e int NetPMGetProfile (int Profileld, NetProfile_t *Profile) 
This plug-in API should return the profile information referred by Profileld. 


e int NetPMGetDefaultProfileld (int *Profileld) 
This plug-in API should return the default profile Id for CM. 


6.2.1 Define Documentation 


6.2.1.1 #define NET_PDP_APN_LEN_MAX 255 


Maximum length of APN in PDP profile [3GPP Defined variable]. 
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6.2.1.2 define NET PDP AUTH PASSWORD LEN NAS 32 


Maximum length of password in PDP profile (used in authentication parameters) [3GPP Defined variable]. 


6.2.1.3 define NET_PDP_AUTH_USERNAME_LEN_MAX 32 


Maximum length of username in PDP profile. 


(used in authentication parameters) [3GPP Defined variable] 


6.2.2 Enumeration Type Documentation 
6.2.2.1 enum NetAddrType_t 
Address Type. 


Enumerator: 


NET_ADDR_IPV4 IPV4 Address type. 
NET_ADDR_IPV6 IPV6 Address type. 


6.2.2.2 enum NetAuthType_t 
PDP Authentication Type. 


Enumerator: 


NET_PDP_AUTH_NONE No authentication. 
NET_PDP AUTH PAP PAP authentication. 
NET_PDP AUTH CHAP CHAP authentication. 


6.2.2.3 enum NetBssType_t 


BSS Information. 


Enumerator: 
NET_EVENT_WLAN_BSSTYPE_INFRA Infrastructure type BSS. 


NET_EVENT_WLAN_BSSTYPE_ADHOC Adhoc type BSS. 
NET_EVENT_WLAN_BSSTYPE_BOTH Both types of BSS: Adhoc and Infrastructure. 


6.2.2.4 enum NetPdpQosType_t 
PDP Qos Type. 


Enumerator: 


NET_PDP_QOS_GPRS GPRS QoS information. 
NET_PDP_QOS_UMTS UMTS QoS information. 
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6.2.2.5 enum NetProfileType_t 
Profile Type. 


Enumerator: 


NET_PROFILE_TYPE_PDP GPRS & WCDMA profiles. 
NET_PROFILE_TYPE_WLAN WLAN profiles. 
NET PROFILE TYPE ALL All type of profile. 


6.2.3 Function Documentation 
6.2.3.1 int NetPMGetDefaultProfileld (int « ProfileId) 
This plug-in API should return the default profile Id for CM. 
Sync (or) Async: 

This is a Synchronous API. 


Important Notes: 


Connection Manager shall allocate and free memory for the output parameters Profileld 
On success, default profile Id shall be copied to Profileld 


Warning: 
None 
Parameters: 
Profileld [OUT] Profile Id will be returned. 
Async Response Message: 
None. 
Returns: 


Return Type (int) 


e NET_ERR_NONE - indicating that the operation has completed successfully. 
e NET_ERR_INVALID_PARAM -Invalid profile Id has been requested 
e NET_ERR_UNKNOWN - Any Other error 


Prospective Clients: 
Connection Manager. 
Example Program: 
int Profileld; 
int result; 


result = NetPMGetDefaultProfileId( &Profileld ); 
if(result == NET_ERR_NONEB)...... 
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6.2.3.2 int NetPMGetProfile (int ProfileId, NetProfile_t « Profile) 
This plug-in API should return the profile information referred by Profileld. 


Sync (or) Async: 


This is a Synchronous API. 


Important Notes: 


On success, profile information shall be copied to Profile parameter in NetProfile_t format 
Connection Manager shall allocate and free memory for the output parameters Profile (of size 
NetProfile_t) 
Plug-in should not free memory allocated to Profile, if profile does not exist 
If profile does not exist, error shall be returned 
Profileld is a positive integer and shall start from 1. O and negative values should not be used for 
Profileld 

Warning: 


None 


Parameters: 


Profileld [IN] Profile Identifier. 
Profile [OUT] Buffer containing the profile. 


Async Response Message: 


None. 


Returns: 
Return Type (int) 


e NET_ERR_NONE - indicating that the operation has completed successfully 
e NET_ERR_INVALID_PROFILEID - Invalid profile Id has been requested 

e NET_ERR_INVALID_PARAM - Input parameter is invalid( Profile is NULL) 
e NET_ERR_UNKNOWN - Any Other error 


Prospective Clients: 


Connection Manager. 


Example Program: 


NetProfile_t Profile; 


int Profileld=1; 

int result; 

result = NetPMGetProfile( Profileld, &Profile ); 
if(result == NET_ERR_NONEB)...... 
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Data Structure Documentation 


7.1 IpAddr_t Union Reference 


7.1.1 Detailed Description 


IP Address. 


Data Fields 


e struct in_addr Ipv4 
IP Version 4 address. 


e struct in6_addr Ipv6 
IP Version 6 address. 


7.1.2 Field Documentation 
7.1.2.1 struct in_addr IpAddr_t::Ipv4 [read] 


IP Version 4 address. 


7.1.2.2 struct in6_addr IpAddr_t::Ipv6 [read] 


IP Version 6 address. 


The documentation for this union was generated from the following file: 


e PMIntf.h 
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7.2 NetAddr_t Struct Reference 


7.2.1 Detailed Description 


Network Address information. 


Data Fields 


e NetAddrType_t Type 
Address Type: IPv4 or IPv6. 


e IpAddr_t Data 
IP Address. 


7.2.2 Field Documentation 
7.2.2.1 NetAddrType_t NetAddr_t:: Type 


Address Type: IPv4 or IPv6. 


7.2.2.2 IpAddr_t NetAddr_t::Data 


IP Address. 


The documentation for this struct was generated from the following file: 


e PMIntf.h 
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7.3 NetAuthInfo_t Struct Reference 


7.3.1 Detailed Description 


PDP Authentication Information. 


Data Fields 


e NetAuthType_t Auth Type 


Authentication type. 


e char UserName [NET_PDP_AUTH_USERNAME_LEN_MAX] 


UserName to be used during authentication. 


e char Password [NET_PDP_AUTH_PASSWORD_LEN_MAX] 


Password to be used during authentication. 


7.3.2 Field Documentation 
7.3.2.1 NetAuthType_t NetAuthInfo_t::AuthType 


Authentication type. 


7.3.2.2 char NetAuthInfo_t::UserName[NET_PDP_AUTH_USERNAME_LEN_MAX] 


UserName to be used during authentication. 


7.3.2.3 char NetAuthInfo_t::Password[NET_PDP_AUTH_PASSWORD_LEN_MAX] 


Password to be used during authentication. 


The documentation for this struct was generated from the following file: 


e PMIntf.h 
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7.4 NetBssInfo_t Struct Reference 


7.4.1 Detailed Description 


BSS Information. 


Data Fields 


e char Ssid [32] 
WLAN SSID. 


e unsigned char BssId [6] 
WLAN BSSID. 


e NetBssType_t BssType 
WLAN BSS Type. 


7.4.2 Field Documentation 
7.4.2.1 char NetBssInfo_t::Ssid[32] 


WLAN SSID. 


7.4.2.2 unsigned char NetBssInfo_t::BssId[6] 


WLAN BSSID. 


7.4.2.3 NetBssType_t NetBssInfo_t::BssType 


WLAN BSS Type. 


The documentation for this struct was generated from the following file: 


s PMIntf.h 
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7.5  NetCMTunmnelInfo_t Struct Reference 


7.5.1 Detailed Description 


Tunnel data: Used in sending tunnel request to Connection Manager. 


Data Fields 


e NetTransportType_t Transport 
Transport type. 


e int Requestld 
Request ID. 


e int DataLength 
Length of tunnel data. 


s void x Data 


tunnel data 


7.5.2 Field Documentation 
7.5.2.1 NetTransportType_t NetCMTunnelInfo_t::Transport 


Transport type. 


7.5.2.2 int NetCMTunnellInfo_t::RequestId 


Request ID. 


7.5.2.3 int NetCMTumnelInfo_t::DataLength 


Length of tunnel data. 


7.5.2.4 void* NetCMTunnellnfo_t::Data 


tunnel data 


The documentation for this struct was generated from the following file: 


e NetCMIntf.h 
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7.6 NetDevInfo_t Struct Reference 
7.6.1 Detailed Description 


Device Info in Connect response event. 


Data Fields 


e int Profileid 


Profile ID for the connection connect response. 


char DevName [NET_DEVICE_NAME_LEN_MAX] 


Device Name of the connection link. 


NetAddr_t DnsAddr [NET_DNS_ADDR_MAX] 


Dns Server Address of the connection link. 


int DnsCount 
No of DNS Address for the connection link. 


NetAddr_t IpAddr 


IP Address for the connection link. 


boolean BNetmask 


Whether subnet mask present or not. 


NetAddr_t SubnetMask 


Subnet mask. 


boolean BDefGateway 


Whether gateway address present or not. 


NetAddr_t Gateway Addr 


Gateway address. 


7.6.2 Field Documentation 
7.6.2.1 int NetDevInfo_t::Profileid 


Profile ID for the connection connect response. 


7.6.2.2 char NetDevInfo_t::DevName[NET_DEVICE_NAME_LEN_MAX] 


Device Name of the connection link. 


7.6.2.3 NetAddr_t NetDevInfo_t::DnsAddr[NET_DNS_ADDR_MAX] 


Dns Server Address of the connection link. 
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7.6.2.4 int NetDevInfo_t::DnsCount 


No of DNS Address for the connection link. 


7.6.2.5 NetAddr_t NetDevInfo_t::IpAddr 


IP Address for the connection link. 


7.6.2.6 boolean NetDevInfo_t::BNetmask 


Whether subnet mask present or not. 


7.6.2.7 NetAddr_t NetDevInfo_t::SubnetMask 


Subnet mask. 


7.6.2.8 boolean NetDevInfo_t::BDefGateway 


Whether gateway address present or not. 


7.6.2.9 NetAddr_t NetDevInfo_t::GatewayAddr 


Gateway address. 


The documentation for this struct was generated from the following file: 


e NetCMIntf.h 
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7.7 NetEventInfo_t Struct Reference 


7.7.1 Detailed Description 


Event Info with Event on callback from Connection Manager. 


Data Fields 


s NetEvent_t Event 


CM Asynchronous event. 


s int Profileld 


Profile Identifier corresponding to the event. 


s NetErr_t Error 


Event Status. 
s void x Data 


Event data: Depending on the event, Event Data will be typecasted to the approprate event info data struc- 
ture. 


7.7.2 Field Documentation 
7.7.2.1 NetEvent_t NetEventInfo_t::Event 


CM Asynchronous event. 


7.7.2.2 int NetEventInfo_t::Profileld 


Profile Identifier corresponding to the event. 


7.7.2.3 NetErr_t NetEventInfo_t::Error 


Event Status. 


7.7.2.4 void« NetEventInfo_t::Data 


Event data: Depending on the event, Event Data will be typecasted to the approprate event info data 
structure. 


The documentation for this struct was generated from the following file: 


e NetCMIntf.h 
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7.8 NetEventTunnelIndInfo_t Struct Reference 


7.8.1 Detailed Description 


Event Info with Event on Indication from Connection Manager. 


Data Fields 


s NetEvent_t Event 


CM Asynchronous Indication. 


e NetTransportType_t TransportType 


Transport type of Tunnel Indication. 


e int Len 
length of the data buffer 


e void x Data 
Event Data Buffer. 


7.8.2 Field Documentation 
7.8.2.1 NetEvent_t NetEventTunnelIndInfo_t::Event 


CM Asynchronous Indication. 


7.8.2.2 NetTransportType_t NetEventTunnelIndInfo_t::TransportType 


Transport type of Tunnel Indication. 


7.8.2.3 int NetEventTunnelIndInfo_t::Len 


length of the data buffer 


7.8.2.4 void« NetEventTunnelIndInfo_t::Data 


Event Data Buffer. 


The documentation for this struct was generated from the following file: 


e NetCMIntf.h 
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7.9 NetPdpProfileInfo_t Struct Reference 


7.9.1 Detailed Description 


PDP Profile Profile Information. 


Data Fields 


e boolean BPrimaryPdpProfile 
Primary or Secondary PDP profile. 


int PrimaryPdpProfileld 
If Sec PDP profile then Profile Id of primary PDP. 


char Apn [NET_PDP_APN_LEN_MAX] 


Network Access Point Name. 


boolean BStaticIpAddr 
Static or Dynamic IP Address. 


NetAddr_t IpAddr 
IP address. 


boolean BStaticDnsAddr 
Static or Dynamic DNS Address. 


int DnsCount 
No of DNS Addresses. 


NetAddr_t DnsAddr [NET_DNS_ADDR_MAX] 
DNS Addresses. 


NetPdpQosInfo_t QosInfo 
QoS information of PDP Profile. 


NetAuthInfo_t AuthInfo 
Authentication info of the PDP profile. 


7.9.2 Field Documentation 
7.9.2.1 boolean NetPdpProfileInfo_t::BPrimaryPdpProfile 


Primary or Secondary PDP profile. 


7.9.2.2 int NetPdpProfilelnfo_t::PrimaryPdpProfileld 


If Sec PDP profile then Profile Id of primary PDP. 
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7.9.2.3 char NetPdpProfileInfo_t::Apn[NET_PDP_APN_LEN_MAX] 


Network Access Point Name. 


7.9.2.4 boolean NetPdpProfileInfo_t::BStaticIpAddr 


Static or Dynamic IP Address. 


7.9.2.5 NetAddr_t NetPdpProfileInfo_t::IpAddr 


IP address. 


7.9.2.6 boolean NetPdpProfileInfo_t::BStaticDnsAddr 


Static or Dynamic DNS Address. 


7.9.2.7 int NetPdpProfileInfo_t::DnsCount 


No of DNS Addresses. 


7.9.2.8 NetAddr_t NetPdpProfileInfo_t::DnsAddr[NET_DNS_ADDR_MAX] 


DNS Addresses. 


7.9.2.9 NetPdpQosInfo_t NetPdpProfileInfo_t::QosInfo 


QoS information of PDP Profile. 


7.9.2.10 NetAuthInfo_t NetPdpProfileInfo_t::AuthInfo 


Authentication info of the PDP profile. 


The documentation for this struct was generated from the following file: 


e PMIntf.h 
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7.10 NetPdpQosGprs_t Struct Reference 


7.10.1 Detailed Description 


PDP GPRS Qos Information. 


Data Fields 


s int Precedence 


Precedence class. 


e int Delay 
Delay class. 


e int Reliability 
Reliability class. 


e int Peak 
Peak throughput class. 


s int Mean 


Mean throughput class. 


7.10.2 Field Documentation 
7.10.2.1 int NetPdpQosGprs_t::Precedence 


Precedence class. 


7.10.2.2 int NetPdpQosGprs_t::Delay 


Delay class. 


7.10.2.3 int NetPdpQosGprs_t::Reliability 


Reliability class. 


7.10.2.4 int NetPdpQosGprs_t::Peak 


Peak throughput class. 


7.10.2.5 int NetPdpQosGprs_t::Mean 


Mean throughput class. 


The documentation for this struct was generated from the following file: 


e PMIntf.h 


Generated on Fri Feb 1 01:01:00 2008 by Doxygen 


7.11 NetPdpQosInfo_t Struct Reference 


45 


7.11 NetPdpQosInfo_t Struct Reference 


7.11.1 Detailed Description 


PDP Qos Information. 


Data Fields 


e NetPdpQosType_t QosType 
PDP QOS type. 


s Qos_t Qos 


Qos Information based on QoS type. 


7.11.2 Field Documentation 
7.11.2.1 NetPdpQosType_t NetPdpQosInfo_t::QosType 


PDP QOS type. 


7.11.2.2 Qos_t NetPdpQosInfo_t::Qos 


Qos Information based on QoS type. 


The documentation for this struct was generated from the following file: 


e PMIntf.h 
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7.12 NetPdpQosUmts_t Struct Reference 


7.12.1 Detailed Description 


PDP UMTS(3G) Qos Information. 


Data Fields 


s int Precedence 


Precedence class. 


e int Delay 


Delay class. 


e int Reliability 
Reliability class. 


e int Peak 
Peak throughput class. 


s int Mean 


Mean throughput class. 


s int TrafficClass 
Traffic Class. 


e int MaxUlBitrate 


Maximum bit rate for uplink. 


e int MaxDIBitrate 


Maximum bit rate for downlink. 


e int GtdUlBitrate 


Guaranteed bit rate for uplink. 


s int GtdDIBitrate 


Guaranteed bit rate for downlink. 


e int DlvryOrder 
Delivery Order. 


e int MaxSduSize 
Maximum SDU(Service Data Unit ) Size. 


e int SduErr 
SDU Error Ratio. 


e int ResBitErr 
Residual BER(Bit Error). 
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s int DivrErrSdu 


Delivery of erroneous SDU. 


e int TransDelay 


Transfer Delay. 


e int ThandlePrio 


Traffic Handling Priority. 


7.12.2 Field Documentation 


7.12.2.1 int NetPdpQosUmts_t::Precedence 


Precedence class. 


7.12.2.2 int NetPdpQosUmts_t: 


Delay class. 


7.12.2.3 int NetPdpQosUmts_t: 


Reliability class. 


7.12.2.4 int NetPdpQosUmts_t: 


Peak throughput class. 


7.12.2.5 int NetPdpQosUmts_t: 


Mean throughput class. 


7.12.2.6 int NetPdpQosUmts_t: 


Traffic Class. 


7.12.2.7 int NetPdpQosUmts_t: 


Maximum bit rate for uplink. 


7.12.2.8 int NetPdpQosUmts_t: 


Maximum bit rate for downlink. 


:Delay 


:Reliability 


:Peak 


:Mean 


:TrafficClass 


:MaxU Bitrate 


:MaxD Bitrate 
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7.12.2.9 int NetPdpQosUmts_t::GtdUlBitrate 


Guaranteed bit rate for uplink. 


7.12.2.10 int NetPdpQosUmts_t::GtdDIBitrate 


Guaranteed bit rate for downlink. 


7.12.2.11 int NetPdpQosUmts_t::DlvryOrder 


Delivery Order. 


7.12.2.12 int NetPdpQosUmts_t::MaxSduSize 


Maximum SDU (Service Data Unit ) Size. 


7.12.2.13 int NetPdpQosUmts_t::SduErr 


SDU Error Ratio. 


7.12.2.14 int NetPdpQosUmts_t::ResBitErr 


Residual BER(Bit Error). 


7.12.2.15 int NetPdpQosUmts_t::DlvrErrSdu 


Delivery of erroneous SDU. 


7.12.2.16 int NetPdpQosUmts_t::TransDelay 


Transfer Delay. 


7.12.2.17 int NetPdpQosUmts_t::ThandlePrio 


Traffic Handling Priority. 


The documentation for this struct was generated from the following file: 


e PMIntf.h 
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7.13 NetProfile_t Struct Reference 


7.13.1 Detailed Description 


Profile data structures: Used between CM and PM Plug-in Interface. 


Data Fields 


e int Profileld 
Profile ID of the profile. 


e NetProfileType_t ProfileType 
Profile Type of the profile. 


s ProfileInfo_t ProfileInfo 
Profile Information of profile. 


7.13.2 Field Documentation 
7.13.2.1 int NetProfile_t::Profileld 


Profile ID of the profile. 


7.13.2.2 NetProfileType_t NetProfile_t::ProfileType 


Profile Type of the profile. 


7.13.2.3 Profilelnfo_t NetProfile_t::ProfileInfo 


Profile Information of profile. 


The documentation for this struct was generated from the following file: 


e PMIntf.h 
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7.14 NetWlanProfileInfo_t Struct Reference 


7.14.1 Detailed Description 


WLAN Profile Profile Information. 


Data Fields 


s NetBssInfo_t BssInfo 
BSS Information. 


e boolean BStaticIpAddr 
Static or Dynamic IP Address. 


e NetAddr_t IpAddr 
IP address. 


e boolean BStaticDnsAddr 
Static or Dynamic DNS Address. 


e int DnsCount 
No of DNS Addresses. 


s NetAddr_t DnsAddr [NET_DNS_ADDR_MAX] 
DNS Addresses. 


7.14.2 Field Documentation 
7.14.2.1 NetBssInfo_t NetWlanProfileInfo_t::BssInfo 


BSS Information. 


7.14.2.2 boolean NetWlanProfileInfo_t::BStaticIpAddr 


Static or Dynamic IP Address. 


7.14.2.3 NetAddr_t NetWlanProfileInfo_t::IpAddr 


IP address. 


7.14.2.4 boolean NetWlanProfileInfo_t::BStaticDnsAddr 


Static or Dynamic DNS Address. 


7.14.2.5 int NetWlanProfileInfo_t::DnsCount 


No of DNS Addresses. 
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7.14.2.6 NetAddr_t NetWlanProfileInfo_t::DnsAddr[NET_DNS_ADDR_MAX] 


DNS Addresses. 


The documentation for this struct was generated from the following file: 


e PMIntf.h 
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7.15 ProfileInfo_t Union Reference 


7.15.1 Detailed Description 


Profile information : Union of PDP and WLAN profile information. 


Data Fields 


e NetPdpProfileInfo_t Pdp 
PDP Profile Information. 


s NetWlanProfileInfo_t Wlan 
WLAN Profile Information. 


7.15.2 Field Documentation 
7.15.2.1 NetPdpProfileInfo_t ProfileInfo_t::Pdp 


PDP Profile Information. 


7.15.2.2 NetWlanProfileInfo_t ProfileInfo_t::Wlan 


WLAN Profile Information. 


The documentation for this union was generated from the following file: 


e PMIntf.h 
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7.16 Qos_t Union Reference 


7.16.1 Detailed Description 


Union of different type of Qos Info. 


Data Fields 


e NetPdpQosGprs_t QosGprs 
GPRS QOS parameters. 


e NetPdpQosUmts_t QosUmts 
UMTS (WCDMA) QOS parameters. 


7.16.2 Field Documentation 
7.16.2.1 NetPdpQosGprs_t Qos_t::QosGprs 


GPRS QOS parameters. 


7.16.2.2 NetPdpQosUmts_t Qos_t::QosUmts 


UMTS (WCDMA) QOS parameters. 


The documentation for this union was generated from the following file: 


e PMIntf.h 
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Chapter 8 


File Documentation 


8.1 ComponentOverview.h File Reference 


8.1.1 Detailed Description 


Component Programming Interface Overview Header Template for Doxygen. 


This file contains configuration information for documentation generation; it does not contain any API- 
specific information. 
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8.2 NetCMConfig.h File Reference 


8.2.1 Detailed Description 


This file describes vendor specific configurable constants of CM Module. 


Defines 


s #define NET_CONNECTIONS_MAX NET_CONNECTIONS_MAX_VENDOR_DEFINED 


Maximum Number of Connections that can be established simultaneously-It is Vendor specific value. 


e #define NET DEVICE NAME LEN MAX  NET_DEVICE_NAME_LEN_MAX_VENDOR_- 
DEFINED 


Maximum length of device name that will be created after a successful connection establishment-It is Vendor 
specific value. 


s #define NET_DNS_ADDR_MAX NET_DNS_ADDR_MAX_VENDOR_DEFINED 
MAX number of DNS Address-It is Vendor specific value. 
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8.3 NetCMError.h File Reference 


8.3.1 Detailed Description 


This file defines the common error code. 


Enumerations 


e enum NetErr_t 1 


NET ERR NONE = 0x00, NET_ERR_UNKNOWN , NET_ERR_APP ALREADY _- 
REGISTERED, NET_ERR_APP_REGISTRATION_FAILED, 


NET_ERR_APP_MAX_CLIENT_REGISTERED, NET_ERR_INVALID_CLIENT, NET_ERR_- 
INVALID_PROFILEID, NET_ERR_NO_ACTIVE_CONNECTIONS, 


NET_ERR_ACTIVE_CONNECTION_EXISTS, NET_ERR_CONNECTION_KILLING, NET_- 
ERR_CONNECTION_OPENING, NET_ERR_CONNECTION_CLOSING, 


NET_ERR_MAX_CONNECTIONS, NET_ERR_MAX_CLIENTS_PER_CONNECTION, NET_- 
ERR_MAX_CONNECTION_KILL_REQ, NET_ERR_MAX_TUNNEL_REQ, 


NET_ERR_ACCESS_DENIED, NET_ERR_INVALID_PARAM, NET_ERR_INVALID_- 
OPERATION, NET_ERR_TRANSPORT, 


NET_ERR_CONNECTION_KILLED } 


Error Defination. 
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8.4 NetCMIntf.h File Reference 


8.4.1 Detailed Description 


This file defines the interface of Connection Manager with the application. 


Data Structures 


s struct NetEventInfo_t 


Event Info with Event on callback from Connection Manager. 


¢ struct NetEventTunnelIndInfo_t 


Event Info with Event on Indication from Connection Manager. 


s struct NetDevInfo_t 


Device Info in Connect response event. 


s struct NetCMTunnellnfo_t 


Tunnel data: Used in sending tunnel request to Connection Manager. 


Typedefs 


e typedef void(* NetAppEvtCb_t )(const NetEventInfo_t *NetEvent) 


callback function: used to notify client application about Asynchronous events. 


Enumerations 


e enum NetEvent_t { 


NET_EVENT_OPEN_RSP, NET_EVENT_CLOSE_RSP, NET EVENT KILL RSP, NET_- 
EVENT_CLOSE_IND, 


NET_EVENT_SUSPEND_IND, NET_EVENT_RESUME_IND, NET_EVENT_TUNNEL_RSP, 
NET_EVENT_TUNNEL_IND } 


Callback Event. 


e enum NetTransportType_t { NET_TRANSPORT_TYPE_PDP, NET_TRANSPORT_TYPE_- 
WLAN } 


Transport Type. 


Functions 


e int NetCMClientRegister (NetAppEvtCb_t EventCb) 
This API shall register the client application with the CM server. 


e int NetCMClientDeRegister () 


This API will deregister the client application with the CM server. 
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e int NetCMConnectionOpen (int Profileld[ ], int ProfileCount) 


This API will establish a data connection for the first entry in the array Profileld. 


e int NetCMConnectionClose (int Profileld) 
This API will terminate the connection referred by the Profileld. 


e int NetCMDeviceGetInfo (int Profileld, NetDevInfo_t *DevInfo) 


This API shall get the device information associated with the connection referred by the Profileld. 


e int NetCMGetActiveProfileIDs (int Profileld[ ], int «ProfileCount) 
This API will retrieve all active profile IDs. 


e int NetCMGetTransportError (int *Error) 


This API returns transport specific error cause for the synchronous return of the last initiated API request. 


e int NetCMConnectionKill (int Profileld) 
This API shall kill active connection referred by the Profileld. 


e int NetCMTunnelRequest (NetCMTunnelInfo_t «TunnelData) 


This API will be used to send any transport specific proprietary information to transport plug-in. 
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8.5 PMIntf.h File Reference 


8.5.1 Detailed Description 


This file defines the interface of Profile Manager with the application/Connection Manager. 


Data Structures 


e union IpAddr_t 
IP Address. 


e struct NetPdpQosGprs_t 
PDP GPRS Qos Information. 


e struct NetPdpQosUmts_t 
PDP UMTS(3G) Qos Information. 


e union Qos_t 


Union of different type of Qos Info. 


s struct NetAddr_t 


Network Address information. 


e struct NetPdpQosInfo_t 


PDP Qos Information. 


s struct NetAuthInfo_t 


PDP Authentication Information. 


e struct NetPdpProfileInfo_t 


PDP Profile Profile Information. 


s struct NetBssInfo_t 


BSS Information. 


s struct NetWlanProfileInfo_t 


WLAN Profile Profile Information. 


e union ProfileInfo_t 


Profile information : Union of PDP and WLAN profile information. 


s struct NetProfile_t 


Profile data structures: Used between CM and PM Plug-in Interface. 
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Defines 


s #define NET_PDP_AUTH_USERNAME_LEN_MAX 32 


Maximum length of username in PDP profile. 


s #define NET_PDP_AUTH_PASSWORD_LEN_MAX 32 
Maximum length of password in PDP profile (used in authentication parameters) [3GPP Defined variable]. 


s #define NET_PDP_APN_LEN_MAX 255 
Maximum length of APN in PDP profile [3GPP Defined variable]. 


Enumerations 


enum NetProfileType_t { NET_PROFILE_TYPE_PDP, NET_PROFILE_TYPE_WLAN, NET_- 
PROFILE_TYPE_ALL } 


Profile Type. 


enum NetAddrType_t { NET_ADDR_IPV4 = 0x0, NET_ADDR_IPV6 = 0x1 } 
Address Type. 


enum NetAuthType_t { NET_PDP_AUTH_NONE = 0x0, NET_PDP_AUTH_PAP = 0x1, NET_- 
PDP_AUTH_CHAP = 0x2 } 


PDP Authentication Type. 


enum NetPdpQosType_t { NET_PDP_QOS_GPRS, NET_PDP_QOS_UMTS } 
PDP Qos Type. 


enum NetBssType_t { NET_EVENT_WLAN_BSSTYPE_ INFRA, NET _EVENT_WLAN_- 
BSSTYPE_ADHOC, NET_EVENT_WLAN_BSSTYPE_BOTH } 


BSS Information. 


Functions 


e int NetPMGetProfile (int Profileld, NetProfile_t *Profile) 
This plug-in API should return the profile information referred by Profileld. 


e int NetPMGetDefaultProfileld (int *Profileld) 
This plug-in API should return the default profile Id for CM. 
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9.1 Foundation API 


9.1.1 Connection Manager Foundation API 
9.1.1.1 Client Registration/De-registration APIs 


Applications have to register with CM in order to use its services. Application shall use the following APIs 
in order to register and de-register with CM. 


1. NetCMClientRegister 


2. NetCMClientDeRegister 


9.1.1.2 Manager APIs 


1. NetCMConnectionOpen 

2. NetCMConnectionClose 

3. Net CMDeviceGet Info 

4. NetCMGetActiveProfilelDs 


5. NetCMConnectionKill 


6. NetCMGetTransportError 


7. NetCMTunnelRequest 


9.1.1.3 Event Callback 


This section describes the callback function which will be used to notify the client application about the 
CM Asynchronous events. This callback function will be called in the CM Client library context. It should 
not call any of the CM foundation APIs. 


The callback function is shown below: 


NetAppEvtCb_t 
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9.1.1.4 Notifications to Application 


Asynchronous Callback Events to Application The list below contains events which shall be sent by 
Connection Manager, asynchronously to all the applications which has an active/in progress connection. 
Each event is sent with a data of type NetEventInfo_t using Callback. 


1. NET_EVENT_OPEN_RSP 


2. NET_EVENT_CLOSE_RSP 


3. NET_EVENT_KILL_RSP 


4, NET_EVENT_CLOSE_IND 


5. NET_EVENT_SUSPEND_IND 


6. NET_EVENT_RESUME_IND 


7. NET_EVENT_TUNNEL_RSP 


Asynchronous Event Notification to Application The list below contains events which shall be sent by 
Connection Manager Server, asynchronously to all the applications using Event Delivery mechanism. 


NET_EVENT_TUNNEL_IND 


Note: Client application receives this event from ED in Base64 encoded format. Application needs to 
decode the event data and typecast the event data into data type: NetEventTunnelIndInfo_t. 


9.1.1.5 definitions 


Error values NetErr_t (Error values) 


Callback Event Data structures 


1. NetEvent_t (Net Event type) 


2. NetEventInfo_t (NET Event Information) 


3. NetDevInfo_t (NET Device Information) 


Address data structures In LiMo Foundation Platform Release 1, only IPv4 address type shall be sup- 
ported. IPv6 may be supported in future releases. 


1. NetAddrType_t (NET Address Type) 
2. NetAddr_t (NET Address) 
NET CM API Data Structures 


1. NetTransportType_t (NET Transport type) 


2. NetCMTunnel Info_t (NET Tunnel Info) 
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NET Authentication Data Structures 


1. NetAuthType_t (NET Authentication Type) 


2. NetAuthInfo_t (NET Authentication Information) 


00S Data Stuctures 


1. NetPdpQosType_t (NET PDP QOS Type) 


2. NetPdpQosGprs_t (NET PDP GPRS QOS Type) 


3. NetPdpQosUmt s_t (NET PDP 3G QOS Type) 


4. Net PdpQosInfo_t (NET PDP QoS information) 


Data Constants NET_DEVICE_NAME_LEN_MAX 
NET_CONNECTIONS_MAX 
NET_PDP_APN_LEN_MAX 
NET_PDP_AUTH_USERNAME_LEN_MAX 
NET_PDP_AUTH_PASSWORD_LEN_MAX 
NET_DNS_ADDR_MAX 
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9.2 Call Flow Diagrams 


9.2.1 DNET CM Call Flow Diagrams 


9.2.1.1 PS Data Connection Establishment and Disconnection procedure 


PS Data call Establishment and Disconnection procedure 
Connedion 
Manager 
Success ailure-return 


N etC MC liem eaae) 


CM send comection establishment request to the 
corresponding transport plugin interface. 


Note CM will initiate a new connection onlyif there is no 
active call exist for the given profile ID . 


a 


NET_EVENT_OPEN_RSP 


Transport Device sends the connection establishment 
response to CM. After processing, CM send 


NET_EVENT_OPEN_RSP event to App. 


Data Transfer 
using Socket, 
Http, ete 


CM send connedion Close request to the corresponding 

NetCMConnedionClo==(Profle Id) ee lan 

Nate: CM will sendthe dose connection request only when 
no other application is using the connection . 


Request sent Success/F ailurereturn 


NET_EVENT_CLOSE_RSP 


Transport Device sends the connection Close response to 
CM. After processing, CM send NET EVENT CLOSE RSP 
evert to App. 


Figure 9.1: PS Data Connection Establishment and Disconnection Procedure 
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9.2.1.2 Aborting a Connection Establishment Procedure 


Aborting a connection establishment procedure 


T Connection 
aina be 


NetC MC onnectionOpentP rofile ld) 
eT 


CM send connection establishment request to the 
corresponding transport plug-in interface. 


Request sert: Success /Failure-return 


Note: CM will initiate a new connection only if there is no 
active call exist for the given profile ID. 


f Application wants to abort 
the connection, then 
application can call 
NetCMC onnectionClose(jto 
abort the connection 


CM send connection Close request to the corresponding 


transport plug-in interface. 
NetCMConnectionClose(Proíle Id) io 
es Ni 


Request sert: Success/Failure-return 


Note: CM will send the close connection request only when 
no other application is using the connection. 


NET_EVENT_CLOSE_RSP 
Transport Device sends the connection Close response to 
CM. After processing, CM send NET_EYENT_CLOSE_RSP 


event to App. 


Figure 9.2: Aborting a Connection Establishment Procedure 
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9.2.1.3 Procedure to Select the Connection for Data Transfer 


Data Transfer: Procedure for selecting the connection 


ass Connection 
kis 


NeatCMConnectionOpentP rofile Id) 


.... Request sert: Success Failure-return 


When Connection established 
successfully, CM will send 
NET_EVENT_OPEN_RSP event to 
application 


NET_EVENT_OPEN_RSP 


On successful connection, The 
event will contain connection 
relatedintodp Addr, DNS Addr, 


Device Name(pdpO0wand), etc 


Socktd = socket 


setsockopt(Sockfd, SOL_SOCKET, SO_BINDTODEMCE, 'pdp0’) 


Linux Socket 


SO_BINDTODEMCE will bind the socket 
with device "pdpO" created for this 


commection. Device name sent on connect 
response will be used in setsockopt() 


Figure 9.3: Procedure to Select the Connection for Data Transfer 
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9.2.1.4 PS Data Connection Suspend and Resume Procedure 


PS Data Call Suspend / Resume Procedure 


Application 


NetCMConnectionOper(P rofie Ich) 


Connection 
Manager 


CM send connection 
establishment request to the 
corresponding transport plucHn 


Request sent: Success/F ailurereturn interface. 


When Connection established 
successfully, CM aill send 
NET_EVENT_OPEN_RSP event to 
application 


NET_EVENT_OPEN_RSP 


Transport Plucin Interface(PDP) sends 
data suspend indication to CM. 
After processing, CM will send 

NET_EVENT_SUSPEND_IND Event to all 

application that uses this connection . 


NET_EVENT_SUSPEND_IND 


Transport PlucHn Interface(PDP) sends 
data resume indication to CM. 
NET_EVENT_RESUME_IND 


After processing, CM will send 
NET_EVENT_RESUME_IND Event to all 
application that uses this connection . 


Figure 9.4: PS Data Connection Suspend and Resume Procedure 
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9.2.1.5 Interaction with PDP Transport Plug-in (Single Connection) 


PDP Transport 
Plugin 


Application 


NetCMC onnectionOper(P rofile Id) 


Connection 
Manager 
Based on profile type, CM will call 

corresponding Transport Plugin Interface. 


If Transport Plucin is not initialized and CM 
has not register Callback function with 
Transport Plug-in then CM will call the 

initialize function . 


etP dplnit ( CbkC Mfune > 


If Return failure then CM ‘will return error to Application 
Otherwise CM will Call Open connection AP] CM pass 
Connid, profile Into. 

Transport PlucHn can return success or failure. If API is failed 
then transport plug-in will return reason for failure. 


eR Return Failure +. .«........ 


etP dpOpenc onnecion L Te 


----Request sent: Success/Failure- return ...... 


ET_EVENT_PDP_ACTIVATION_RSP 


df 1ET_EVENT_OPEN_RSP 


NetCMConnedionClose(Profle Id) 


4 --- Request sent: Success ailure- return ..... 
etPdpCloseConnedtion (C onnld)—_——_» 


ET_EVENT_PDP_DEACTIVATION_RSP 
ET_EVENT_CLOSE_RSP 


Figure 9.5: Interaction with PDP Transport Plug-in (Single Connection) 
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9.2.1.6 Interaction with WLAN Transport Plug-in (Single Connection) 


Connection Wlan Transport 
Manager Plugin 
Based on profile type, CM ‘will call 

corresponding Transport Plugin Interface. 


If Transport Plugin is not initialized and CM 
has not register Callback function with 


Application 


NetCMConnectionOper(P roiie Id) 


Transport Plug-in then CM ‘will call the 
initialize function . 


ehanint ( CbkCM func Th 


If Retum failure then CM will return error to Application 
Otherwise CM will Call Open connection API CM pass 
Connid, profile Into. 

Transport PlucHn can return success or failure. If API is failed 
then transport plug-in sill return reason for failure. 


etVlanOpenc onnection L 


qs Request sent: Success/F ailure-return- - - ---- 


ERT EVENT AN CONNECTION RSP 
ET_EVENT_OPEN_RSP 


NetCMConnedionClose(Profile Id) 


1 --- Request sent: Suocess/F alure- return - ---- 
etivanCloseC onnection (C onnid 


+++ --Request sent: Success F ailure-return- - ----- 


ET_EVENT_VWLAN_DISCONNECTION_RSP 


de 0ET_EVENT_CLOSE_RSP 


Figure 9.6: Interaction with WLAN Transport Plug-in (Single Connection) 
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9.2.1.7 Interaction with PDP Transport Plug-in (Multiple Connections) 


PDP Transport 
Plugin 


via Connedion 
gE 
Based on profile type, CM will call 
corresponding Transport Plugin Interface. 


If Transport Plucin is not initialized and CM 
has not register Callback function with 
Transport Plug-in then CM will call the 

initialize function . 


NetCMConnecionOper(Profile Id1) 


etP dplnit ( CbkCM func }————» 


eo REUrn Failure... ............ 


----Request sent: Success/F ailure- return ...... 
NET_EYENT_PDP_ACTIWATION_RSP 
NET EENT OPEN RSP 


NetCMComectionOper(Profile 112) 
etP dpOpenc onnection (C onnl d2)———» 


----Request sent: Success/F ailure- return. «---- 
NET_EVENT_PDP_ACTIVATION_RSP 


NET_EVENT_OPEN_RSP 


Application can use any of the two 
connected links for data transfer 
using data plane 


NetCMCornectionC lose(P rofle Id1) 


~#----Request sent: Success/F ailure- return ++... 
etP dpClosec onnection (C omni ct }——+ 
kee Request sent: Success/F alure-return 


ET_EVENT_PDP_DEACTIVATION_RSP 
jen NET_EVENT_CLOSE_RSP 


NetCMConnedionClosefP rofle 1021 


@----Request sent: SuccessF ailure- return 
etP dpCloseC onnection (C onnl d2)———» 


ET_EVENT_PDP_DEACTIVATION_RSP 
NET_EVENT_CLOSE_RSP 


Figure 9.7: Interaction with PDP Transport Plug-in (Multiple Connections) 
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9.2.1.8 Interaction with Mixed Transport Plug-in (Multiple Calls) 


PDP Trareport 
Plug-in 


he ali Connection Wan Trareport 
E bond PS 
NetCMConnectionOper(Profik 141) Based on profi type, CM wil call 
corresponding Tram port Plugin Interface. 


etlanOpenC onnection (C onnld1)——— 
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Figure 9.8: Interaction with Mixed Transport Plug-in (Multiple Calls) 
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9.2.1.9 Open Connection (Usage of Profile List) 
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CM will read the first profile in the first and 
start processing on that Profile ID. 
Processing of other Profile ID is outside CM 


scope inR 1. 


Based on profile type, CM will call 
corresponding Transport Plugin Interface. 


If Transport Plucin is not initialized and CM 
has not register Callback function with 
Transport Plug-in then CM will call the 

initialize function . 


etVianinit ( CbkCM func }+—————_» 


If Return failure then CM ‘will return error to Application 
Otherwise CM will Call Open connection AP] CM pass 
Connid, profile Into. 
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Figure 9.9: Open Connection (Usage of Profile List) 
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9.2.1.10 Open Connection: Link Sharing 
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Figure 9.10: Open Connection: Link Sharing 
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9.2.1.11 Usage of API: NetCMConnectionKill (in case of WLAN) 
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Figure 9.11: Usage of API: NetCMConnectionKill (in case of WLAN) 
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9.2.1.12 Tunnel Request and Response Sequence 


Application 


NetCM TunnelR equest) 


Request sent: Success ailure 
If success then return the request id 


NET_EVENT_TUNNEL_RSP 


Response data contains the request 
ld. It also contains the data and data 
length This Indication will only be 
given tothe requested application. 


13 CM sill only works as router for tunnel API. 
2) CM ill not do any processing of request or response. 
3) Understanding of request isthe responsi ibility of Tarpon plugin interface 


request to transport plug-in using the 
same request id which will be used for 
mappingthe response to request. 


Nean T unnelRequestó) 


Request sent: Success ailure 


NET_EVENT_VVLAN_TUNNEL 


Response data contains the request Id 
which has been passed during 
NetvWlanT unnelRequest API. lt also 
contain the data and data length which 
needs to forwarded to application. 


Figure 9.12: Tunnel Request and Response Sequence 


Wlan Transport 
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CM will generate a request id and return 
request id to application. CM will send the 
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9.2.1.13 Tunnel Unsolicited Indication 


= 7 WLAN Transport 


Return SuccessFailure 


Sequence NetvMlaninit() 


NET_EVENT_VWLAN_TUNNEL 


Response data contans 
Request id as invalid 
entry. It contains the data 
and data length which 
needs to be forwarded to 
CM publishes tunnel indication the application. 

using notification manager and 
pass the data which in turn is 
passed to the registered 
applications. 


NET_EVENT_TUNNEL_IND 


NET_EYENT_TUNNEL_IND 


Note: 
1)CM wil sendthe Indication using event delivery mechanism. CM will publish the Tunnel Indication 


and subscribed application will receive notification for the same. So each application needs to register 
sath Event Delivery module for receiving unsolicited tunnel indication from Data Networking. 
2) Request ID: A negative integer is considered as an invalid value for request ID. 


Figure 9.13: Tunnel Unsolicited Indication 
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9.2.1.14 Tunnel Unsolicited MT PDP Indication 
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Figure 9.14: Tunnel Unsolicited MT PDP Indication 
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9.2.1.15 Usage of API: NetCMGetTransportError 
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Figure 9.15: Usage of API: NetCMGetTransportError 
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